package com.ruoyi.system.service;


import com.alibaba.fastjson.JSONObject;
import com.ruoyi.common.core.domain.entity.SysAttachment;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;
import java.util.Map;

/**
 * 附件Service接口
 * 
 * @author ruoyi
 * @date 2025-08-02
 */
public interface ISysAttachmentService 
{
    /**
     * 查询附件
     * 
     * @param id 附件主键
     * @return 附件
     */
    public SysAttachment selectById(String id);

    /**
     * 查询附件列表
     * 
     * @param sysAttachment 附件
     * @return 附件集合
     * @throws Exception
     */
    public List<Map<String, Object>> queryList(Map<String, Object> param) throws Exception;
    
    /**
     * 查询附件列表
     * 
     * @param sysAttachment 附件
     * @return 附件集合
     */
    public List<SysAttachment> selectList(SysAttachment sysAttachment);

    /**
     * 新增附件
     * 
     * @param sysAttachment 附件
     * @return 结果
     */
    public int insert(SysAttachment sysAttachment);

    /**
     * 修改附件
     * 
     * @param sysAttachment 附件
     * @return 结果
     */
    public int update(SysAttachment sysAttachment);

    /**
     * 批量删除附件
     * 
     * @param ids 需要删除的附件主键集合
     * @return 结果
     */
    public int deleteByIds(String[] ids);

    /**
     * 删除附件信息
     * 
     * @param id 附件主键
     * @return 结果
     */
    public int deleteById(String id);

    /**
     * 上传附件
     * @param file 文件对象
     * @param bucketName 存储桶名称
     * @return JSONObject
     * @throws Exception 
     */
    JSONObject upload(MultipartFile file, String bucketName) throws Exception;

    /**
     * 创建存储桶
     * @param bucketName 存储桶名称
     * @throws Exception
     */
    public void createBucket(String bucketName) throws Exception;

}
